Peek's COM interface now supports a few useful operations:
To specify a set of filters, use the Peek GUI to define them and save them as part of your capture template file.
To extract information out of a capture, save the capture to a file and then parse the file. Text packet lists are especially good for extracting summary strings and addresses.
Here's some Visual Basic sample code:
' acquire connection to app
Dim myApp
On Error Resume Next
myApp = GetObject(, "EtherPeek.Application")
If app Is Nothing Then
myApp = CreateObject("EtherPeek.Application")
End If
' create a new capture window, using an existing capture template
Dim myDoc
myDoc = myApp.Documents.Open("C:\foo\My Capture Template.ctf")
' start capture
myDoc.IsCapturing = True
' wait a while
' ...
' stop capture
myDoc.IsCapturing = False
' save the captured packets
myDoc.Save("C:\foo\My Saved Packet List.txt", 4)
| Read-Only Properties | ||
| Name | BSTR | AiroPeek NXor AiroPeek |
| Application | IDispatch* | the application object |
| Parent | IDispatch* | the application object |
| Documents | IDispatch* | the object that knows how to open documents |
| ActiveDocument | IDispatch* | NULL (not implemented) |
| Windows | IDispatch* | NULL (not implemented) |
| ActiveWindow | IDispatch* | NULL |
| FullName | BSTR | same as Name |
| Path | BSTR | empty string (not implemented) |
| Settable Properties | ||
| Caption | BSTR | title of main window (usually AiroPeek NX) |
| Interactive | BOOL | always TRUE. Setting does nothing. |
| Visible | BOOL | shows/hides the application |
| Left | LONG | moves the app window |
| Top | LONG | moves the app window |
| Width | LONG | resizes the app window |
| Height | LONG | resizes the app window |
| Minimized | BOOL | shrinks/expands the app window |
| Maximized | BOOL | zooms/restores the app window |
| Methods | ||
| void Beep() | makes noise | |
| void Quit() | exits the app | |
| void Minimize() | shrinks the app. Same as setting Minimized = True | |
| void Maximize() | zooms the app. Same as setting Maximized = True | |
| void Restore() | makes the app a movable window | |
| void CloseAll() | closes all open windows | |
| void CascadeWindows() | stacks all open windows | |
| void TileVertically() | tall skinny windows | |
| void TileHorizontally() | short wide windows | |
| void ArrangeIcons() | rearranges deck chairs on your MDI Titanic | |
| void NextWindow() | flips to the next open window | |
| void PreviousWindow() | flips to the previous open window | |
| void ViewFilters() | opens Filters window | |
| void ViewNameTable() | opens Name Table window | |
| void ViewLog() | opens Log window | |
| void ViewAlarms() | opens Alarms window | |
The Documents
object exists only to open files. All other properties and methods are unimplemented.
| Method | |
| IDispatch* Open(BSTR File) | Opens the given file. If the given file is a packet trace file, returns an IDispatch* reference to the Document object that file window. If the file is a capture template file, returns an IDispatch* reference to the Document object for that capture window. |
The Document class represents a capture or file window. You acquire a reference to a document object through app.Documents.Open(BSTR File).
| Read-Only Properties | ||
| Application | IDispatch* | NULL (not implemented) |
| Parent | IDispatch* | NULL (not implemented) |
| Name | BSTR | window title |
| Settable Properties | ||
| IsCapturing | BOOL | set to True to start capture, set to False to stop capture |
| Methods | ||
| void Close() | Closes the window | |
| void Save(BSTR FilePath, INT formatIndex) | Saves all packets to a file. format index is the index into the format combo box in Peek's Save dialog:
| |
WildPackets, Inc.
1340 Treat Blvd., Suite 500
Walnut Creek, CA 94597 USA
(925) 937-3200
http://www.wildpackets.com/
sdkhelp@wildpackets.com
Copyright © 2001-2003 WildPackets, Inc.
All rights reserved.